Programmer's Aid for VIC 20™ ^^p^^^^ $3.98 



copyright 
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BASIC KEYWORDS 



Words Definition 

ABS Absolute Value 

AND Logic operation 

ASC Returns value of ASCII 

ATN Arctangent 

CHR$ String Character 

CLOSE Closes file 

CLR Clears Variables 

CMD Output to device or file 

CONT Continue program 

COS Cosine 

DATA Data to be read 

DEF Define function 

DIM Demention array 

END End program 

EXP VAL of "e" to power 

FN Variable prefix 

FOR Used for loop 

PRE Bytes available 

GET Accept single cfiaracter 

GOSUB Execute subroutine 

GO TO Execute at line 

IF Logic operation 

INPUT Accept value 

INPUT* Accept value 

INT Returns Integer 

LEFTS Left part of string 

LEN Character in string 

LET Assign value 

LIST Basic program list 

LOAD Basic program load 

LOG Returns Logarithm 

M1D$ Center of string 

NEW Remove basic program 

NEXT Used for Loop 

NOT Logic operation 

ON Use with goto or gosub 

OPEN Open file or device 

OR Logic operation 

PEEK Returns number value in memory 

POKE Places number value in memory 

POS Print position 

PRINT Prints to screen 

PRINT* Prints to file 

READ Obtains data 

REM Remark 

RESTORE Reread data 

RETURN Returns after Gosub 

RIGHTS Right part of string 

RND Random number 

SAVE Save basic program 

SGN Returns sign 

SR^ Trig function sine 

SPC( Prints spaces 

SQR Square root 

STEP Specifies increments 

STOP Stop basic program 

STR$ String of a number 

SYS Transfer to sub system 

TAB( Specific column print 

TAN Tangent 

THEN Used with IF statement 

TO Used with FOR statement 

USR Pass machine lang. parameter 

VAL Return value of string 

VERIFY Checks specific program 

WAIT Stops basic program execution 



Tokens 
Dec. Hex 



182 
175 
198 
193 
199 
160 
156 
157 
154 
190 
131 
150 
134 
128 
189 
165 
129 
184 
161 
141 
137 
139 
133 
132 
181 
200 
195 
136 
155 
147 
188 
202 
162 
130 
168 
145 
159 
176 
194 
151 
185 
153 
152 
135 
143 
140 
142 
201 
187 
148 
180 
191 
166 
186 
169 
144 
196 
158 
163 
192 
167 
164 
183 
197 
149 
146 



B6 

AF 

C6 

CI 

C7 

AO 

9C 

9D 

9A 

BE 

83 

96 

86 

80 

BD 

A5 

81 

B8 

Al 

8D 

89 

8B 

85 

84 

B5 

C8 

C3 

88 

9B 

93 

BC 

CA 

A2 

82 

A8 

91 

9F 

BO 

C2 

97 

B9,- 

99 

98 

87 

8F 

8C 

8E 

C9 

BB 

94 

B4 

BF 

A6 

BA 

A9 

90 

C4 

9E 

A3 

CO 

A7 

A4 

B7 

C5 

95 

92 



SCREEN AND BORDER COLOR COMBINATIONS 



Screen 



Border 





BLK WHT RED 














BIk 


Wht 


Red 


Cyan 


Pur 


Grn 


Blu 


Yel 


BLK 


008 


009 


010 


Oil 


012 


013 


014 


015 


WHT 


024 


025 


026 


027 


028 


029 


030 


031 


RED 


040 


041 


042 


043 


044 


045 


046 


047 


CYAN 


056 


057 


058 


059 


060 


061 


062 


063 


PUR 


072 


073 


074 


075 


076 


077 


078 


079 


GRN 


088 


089 


090 


091 


092 


093 


094 


095 


BLU 


104 


105 


106 


107 


108 


108 


109 


110 


YEL 


120 


121 


122 


123 


124 


125 


126 


127 


ORANGE 


136 


137 


138 


139 


140 


141 


142 


143 


LTORG 


152 


153 


154 


155 


156 


157 


158 


159 


PINK 


168 


169 


170 


171 


172 


173 


174 


175 


LTCVN 


184 


185 


186 


187 


188 


189 


190 


191 


LT PUR 


200 


201 


202 


203 


204 


205 


206 


207 


LTGRN 


216 


217 


218 


219 


220 


221 


222 


223 


LT BLU 


232 


233 


234 


235 


236 


237 


238 


239 


LT YEL 


248 


249 


250 


251 


252 


253 


254 


255 


POKE 36879. (number from table 


above) 



















CODE 




CHAR 






■ ASCII CODES ■ 






Decimal 


Hex 














080 


50 


P 


CODE 




CHAR 


CODE 




CHAR 081 


51 


Q 


Decimal 


Hex 




Decimal 


Hex 




082 


52 


R 


000 


00 


NULL 


040 


28 


( 


083 


53 


S 


001 


01 


SOH 


041 


29 




084 


54 


T 


002 


02 


STX 


042 


2A 




085 


55 


U 


003 


03 


ETX 


043 


2B 


+ 


086 


56 


V 


004 


04 


EOT 


044 


2C 




087 


57 


w 


005 


05 


ENQ 


045 


2D 




088 


58 


X 


006 


06 


ACK 


046 


2E 




089 


59 


Y 


007 


07 


BEL 


047 


2F 


1 


090 


5A 


Z 


008 


08 


BS 


048 


30 





091 


58 


[ 


009 


09 


HT 


049 


31 


1 


092 


5C 


backslash 


010 


OA 


LF 


050 


32 


2 


093 


5D 




Oil 


OB 


VT 


051 


33 


3 


094 


5E 




012 


OC 


FF 


052 


34 


4 


095 


5F 


013 


OD 


CR 


053 


35 


5 


096 


60 


SPC 


014 


OE 


SO 


054 


36 


6 


097 


61 


a 


015 


OF 


SI 


055 


37 


7 


098 


62 


b 


016 


10 


DLE 


056 


38 


8 


099 


63 


c 


017 


11 


DCl 


057 


39 


9 


100 


64 


d 


018 


12 


DC2 


058 


3A 




101 


65 


e 


019 


13 


DC3 


059 


3B 




102 


66 


f 


020 


14 


DC4 


060 


3C 


< 


103 


67 


g 


021 


15 


NAK 


061 


3D 


= 


104 


68 


h 


022 


16 


SYN 


062 


3E 


> 


105 


69 


i 


023 


17 


ETB 


063 


3F 


? 


106 


6A 


j 


024 


18 


CAN 


064 


40 


@ 


107 


6B 


k 


025 


19 


EM 


065 


41 


A 


108 


6C 


1 


026 


lA 


SUB 


066 


42 


B 


109 


6D 


m 


027 


IB 


ESC 


067 


43 


C 


110 


6E 


n 


028 


IC 


FS 


068 


44 


D 


111 


6F 





029 


ID 


GS 


069 


45 


E 


112 


70 


p 


030 


IE 


RS 


070 


46 


F 


113 
114 


71 

72 


q 
r 


031 


IF 


US 


071 


47 


G 


032 


20 


SPC 


072 


48 


H 


115 


73 


s 


033 


21 


1 


073 


49 


1 


116 


74 


t 


034 


22 




074 


4A 


J 


117 


75 


u 


035 


23 


* 


075 


4B 


K 


118 


76 


V 


036 


24 


$ 


076 


4C 


L 


119 


77 


w 


037 


25 


% 


077 


4D 


M 


120 


78 


X 


038 


26 


& 


078 


4E 


N 


121 


79 


y 


039 


27 




079 


4F 





122 


7A 


z 



MUSICAL NOTE TABLE 



Note 


Decimal 


Hex 


Note 


Decimal 


Hex 


C 


135 


87 


G 


215 


D7 


c# 


143 


8F 


G# 


217 


D9 


D 


147 


93 


A 


219 


DB 


D# 


151 


97 


A* 


221 


DO 


E 


159 


9F 


B 


223 


DF 


F 


163 


A3 


C 


225 


El 


F# 


167 


A7 


C# 


227 


E3 


G 


175 


AF 


D 


228 


E4 


G# 


179 


B3 


D# 


229 


E5 


A 


183 


B7 


E 


231 


E7 


A# 


187 


BB 


F 


232 


E8 


B 


191 


BF 


F" 


233 


E9 


C 


195 


C3 


G 


235 


EB 


C* 


199 


C7 


G* 


236 


EC 


D 


201 


C9 


A 


237 


ED 


D# 


203 


CB 


A# 


238 


EE 


E 


207 


CF 


B 


239 


EE 


F 


209 


01 


C 


240 


FO 


f# 


212 


D4 


C# 


241 


Fl 



Voicel POKE 36874,X Octaves 1.2,3 
Voice2 POKE 36875,X Octaves 2.3.4 
Voice3 POKE 36876.X Octaves 3,4,5 
Noise POKE 36877,X 
Volume POKE 36878.0 OFF 
To POKE 36878,15 Maximum 



SERIAL I/O 




Pin Function 

1 SERIAL SRQ IN 

2 GND 

3 SERIAL ATN IN/OUT 

4 SERIAL CLK IN/OUT 

5 SERIAL DATA IN/OUT 

6 RESET 



PRINTER COMMAND CODES 



CHRS(14) 


Double Width 


CHRS(IO) 


Line Feed 


CHRS(13) 


Carriage return 


CHRS(8) 


Graphic mode 


CHRS(15) 


Standard 


CHRS(16) 


Position addr 


CHRS(27) 


Dot Position 


CHRS(26) 


Graphic repeat 


CHRS(17) 


Upper/Lower 


CHR$(145) 


Upper Case 


CHR$(18) 


RVS ON 


CHR$(146) 


RVS OFF 



COLOR CODES 






BLACK 


8 


ORANGE 


1 


WHITE 


9 


LT ORANGE 


2 


RED 


10 


PINK 


3 


CYAN 


11 


LT. CYAN 


4 


PURPLE 


12 


LT. PURPLE 


5 


GREEN 


13 


LT GREEN 


6 


BLUE 


14 


LT BLUE 


7 


YELLOW 


15 


LT YELLOW 



AUDIO VIDEO 




Pin 


Function 


1 


+5V, REGULATED 


2 


GND 


3 


AUDIO 


4 


VIDEO LOW 


5 


VIDEO HIGH 



KhRNAl ROIITINLS 



Name AddrcM 
Decimal 

ACPTR 65445 

CHKIN 65478 

CHKOUT 65481 

CHRIN 65487 

CHROUT 65490 

ClOUT 65488 

CLALL 65511 

CLOSE 65475 
CLRCHN - 65475 

GETIN 65512 

lOBASE 65523 

USTEN 65457 

LOAD 65493 

MEMBOT 65436 

MEMTOP 65433 

OPEN 65472 

PLOT 65520 

RDTIM 65502 

READST 65463 

RESTOR 65415 

SAVE 65496 

SCNKEY 65439 

SCREEN 65517 

SECOND 65427 

SETLFS 65466 

SETMSG 65424 

SETNAM 65469 

SETTIM 65499 

SE1TM0 65422 

STOP 65505 

TALK 65460 

TKSA 65430 

UDTIM 65514 

UNLSN 65454 

UNTLK 65451 

VECTOR 65412 



Deacripdon 

Hex 

$FFA5 Input A Byte Serial Port 
$FFC6 Open channel for input 
$FFC9 Open channel for output 
$FFCF Input char, from channel 
$FFD2 Output Char to channel 
$FFA8 Output Byte Serial Port 
$FFE7 Close all channels+filei 
$FFC3 Close a specified logical file 
$FFC3 Close I/O channels 
$FFE4 Get char from Buffer 
$FFF3 Return I/O Base addr, 
$FFB1 Command serial to listen 
$FFD5 Load RAM from device 
$FF9C Read/Set memory bottom 
$FF99 Read/Set memory top 
$FFCO Open a logical file 
$FFFO Read/setX,Ycursorposition 
$FFDE Read clock 
$FFB7 Read I/O status word 
$FF8A Restore 1/0 Vectors 
$FFD8 Saue RAM to device 
$Ff-9F Scan keyboard 
$FFED Return X,Y organization 

of screen 
$FF93 Send secondary addr. 
$FFBA Set Logical 1st + 2nd 

addresses 

$ FF90 Control KERN AL messages 

$FFBD Set Filename 

$FFDB Set clock 

$FFA2 Set Serial Bus timeout 

$FFE1 Scan stop key 

$FFB4 Command serial Bus 

device to talk 
$FF^6 Send secondary addr. 

after talk 
$FFEA Increment clock 
$FFAE Command serial bus to 

unlisten 

$FFAB Command serial bus to 
untalk 

$FF84 Read/Set Vectored I/O 



KERNAL ERROR CODES 



Routine ended by stop key 
Too many open files 
File already open 
File not open 
File not found 



5 Device not present 

6 File is not an INPUT file 

7 File is not an OUTPUT file 

8 File name missing 

9 Illegal device number 



Address 




$00 


$FF 


$100 


$13E 


$100 


$1FF 


$100 


$10A 


$200 


$258 


$259 


$292 


$293 


$294 


$295 


$2FF 


$300 


$301 


$302 


$32F 


$330 


$3FB 


$400 


$FFF 


$1000 


$1DFF 


$1E00 


$1FFF 


$2000 


$3FFF 


$4000 


$5FFF 


$6000 


$7FFF 


$8000 


$8FFF 


$9000 


$900F 


$9110 


$912F 


$9400 


$95FF 


$9600 


$97FF 


$9800 


$9BFF 


$9C00 


$9FFF 


$A000 


$BFFF 


$COO0 


$DFFF 


$E000 


$FFFF 



MEMORY MAP 



Function 

Page zero, Pointers, Accumulators, Rags 
Tape Error Log 
Microprocessor Stack 
Floating/String work area 
Basic Input Buffer 

Operating system, tables, flags, keyboard 
VIC Chip 

Operating system, RS232 pointers, etc. 
Error message link 
Vectors 
Tape I/O 

3K Expansion RAM 

User Basic RAM (unexpanded VIC") 

Basic memory screen area (unexpanded VIC" 

8K Expansion area 

8K Expansion area 

8K Expansion area 

Character generator ROM 

VIC Chip (6560) 

VIA Chip (6522) 

Color RAM area 

Color RAM area 

I/O Block 2 

1/0 Block 3 

Expansion ROM 

Basic ROM 

ROM Kernal Operating System 



USER PORT 



Pin 


Function ^^^^^^ 


Pin 


Function 


1 


GND 


A 


GND 


2 


+5V 


B 


CBl 


3 


RESET 


C 


PBO 


4 


JOYO 


D 


PBl 


5 


JOYl 


E 


PB2 


6 


JOY2 


F 


PB3 


7 


LIGHT PEN 


H 


PB4 


8 


CASSETTE SWITCH 


J 


PB5 


9 


SERIAL ATN IN 


K 


PB6 


10 


+9V 


L 


PB7 


11 


GND 


M 


CB2 


12 


GND 


N 


GND 




1 2 3 4 5 6 


7 8 9 10 


11 12 






A B C D E F 


H J K L 


M N 



CURRENT KEY BEING HELD 



Memory Location 197 or 


$C5 






Peek (197) 












t\tY 


# 


t\t. I 




Key 




KEY # 


*~ 


08 


• 


14 




49 




1 


00 


1 


54 




^c. 


V/ 97 
V Z / 




56 




45 




1 Q 


W U" 


3 


01 




22 


n 


A Q 
'to 




4 


57 




37 


[ 


12 


Y 11 


5 


02 




30 


J 




2 33 


6 


58 


/"■DC f 

CKo \ 


31 




6.6. 




7 


03 




£.6 


L 


21 


c;P RAR "^9 






Fl 


39 


M 


36 


Commodore 


8 


59 


F3 


47 


N 


28 


oniit ana 


9 


04 


F5 


55 





52 


L-ontroi i\ey 





60 


F7 


63 


p 

r 




PEEK(653) $028 D 


+ 


05 


A 


17 






W til 1 U=bhiit 




61 


B 


35 




10 


IF BIT l=Commodore 


3 


06 


C 


34 


S 


41 


IF BIT 2=CTRL Key 


HOM 


62 


D 


18 


T 


50 


DEL 


07 













Decimal 


Hex 


36864 


$9000 


36865 


$9001 


36866 


$9002 


36867 


$9003 


36868 


$9004 


36869 


$9005 



VIC CHIP REGISTERS 



Description 

BITS 0-6 Horiz. Centering 
Vertical Centering 
BITS 0-6 # of Columns 
BITS 0-6 # of Rows 
BIT Sets Char. Height 
BITS 0-3 Char. Gen. Addr. 



Bits 

0000 
0001 



Decimal 

32768 
33793 



36870 
36871 
36872 
36873 
36874 
36875 
36876 
36877 
36878 

36879 



$9006 
$9007 
$9008 
$9009 
$900A 
$900B 
$900C 
$900D 
$900E 

$900F 



0010 34816 

0011 35840 

1000 00000 

1001 XXXXX(""^,7'- 

1010 xxxxx ' 

1011 xxxxx 

1100 4096 

1101 5120 
1110 6144 
nil 7168 
Horiz. Pos. Light Pen 
Vert. Pos. Light Pen 
Paddle X 

Paddle Y 

Voicel 

Voice2 

Voice3 

White Noise 

Volume Bits 0-3 

Auxiliary Color Bits 4-7 

Screen and Border colors 

Bits 4-7 Screen color 

Bit 3 RVS ON/OFF 

Bits 0-2 Border Color 



Hex 

$8000 
$8400 

$8800 
$8C00 
$0000 

xxxx 
xxxx 
xxxx 

$1000 
$1400 
$1800 
$1000 



EXPANSION/CARTRIDGE CONNECTOR 



Pin 

1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 



Function 

GND 

CDO 

CDl 

CD2 

CD3 

CD4 

CDS 

CD6 

CD7 

BLKl 

BLK2 

BLK3 

BLK5 

RAMI 

RAM2 

RAMS 

VR/W 

CR/W 

IRQ 
NC 

-I-5V 

GND 



Pin 

A 
B 

c 

D 
E 
F 
H 
J 
K 
L 
M 
N 
P 
R 
S 
T 
U 
V 
W 
X 
Y 
Z 



Function 

GND 
CAO 
CAl 
CA2 
CAS 
CA4 
CA5 
CA6 
CA7 
CAS 
CA9 
CAIO 
CAll 
CAl 2 
CAl 3 
I/02 
1/03 
S02 
NMl 
RESET 
NC 
GND 



12 3456 789 1011 121314 15161718 19202122 



ABCDEFHJKLMNPRSTUVWXYZ 



JOYSTICK CONTROL REGISTERS 



Decimal 

37 139 



Hex 

$9113 



S7137 $9111 



37154 $9122 



S7152 $9120 



Description 

DDR Port A 
Set to Input 
PORTA 
BIT2 = UP 
BITS = DOWN 
BIT4 = LEFT 
BITS = FIRE 
DDR PORT B 
Set to 127 to 
read JOYSTICK 
255 for KEYS 
BIT7 = RIGHT 



SCREEN MEMORY LOCATIONS 



Unexpanded VIC 
Decimal Hex 

7680-8191 $1E00-$1FFF 

Expanded VIC 
Decimal Hex 

4096-4607 $1000-$11FF 



COLOR RAM LOCATIONS 



Unexpanded VIC 
Decimal Hex 

38400-38911 $9600-$97FF 

Expanded VIC 
Decimal Hex 

S7888-38399 $9400-$95FF 



TO SET SCREEN 
TO COLOR C 

POKE36879. 
(PEEK(S6879) and 
15)ORC'16 

TO SET BORDER 
TO COLOR C 

POKE36879. 

(PEEK(36879)and 

248)ORC 

TO SET INVERSE 
VIDEO, 

POKES6879, 

(PEEK(36879)and 

247) 



GAME PORT 




Pin 


Des. 


1 


JOYO 


2 


JOYl 


3 


J0Y2 


4 


JOYS 


5 


POTY 


6 


LTPEN 


7 


+5 


8 


GND 


9 


POTX 



Note 



lOOMA 



